Telegram Group & Telegram Channel
Forwarded from Learn Python
⌯ الديكوريتر ( Decorators ) :
ـ = = = = = = = = = = = = = = =
• الديكوريتر (أو ما يعرف بالمُعلِّق الوظيفي في بايثون) هو أسلوب برمجي يُستعمل للتعديل على سلوك الدوال أو الكلاسات دون الحاجة إلى التعديل على بنية الكود الأصلي.

• يتم ذلك عن طريق تغليف الدالة/الكلاس بدالة خارجية (تسمى الديكوريتر) تضيف أو تحسّن وظائف معيّنة قبل أو بعد أو حتى أثناء تنفيذ الدالة الأساسية.

⌯ كيف نُعرِّف (نستخدم) الديكوريتر ؟
ـ = = = = = = = = = = = = = = = = =
• عادةً يُنشأ الديكوريتر بواسطة دالة عليا ( Higher Order Function ) تستقبل دالة كمدخل، ثم تُرجع دالة جديدة بداخلها، تحتوي على كود إضافي أو معدل (التغليف).

مثال بسيط :

def my_decorator(func):
def wrapper():
print("قبل تنفيذ الدالة ...")
func()
print("بعد تنفيذ الدالة ...")
return wrapper

@my_decorator
def say_hello():
print("مرحباً بالجميع!")

say_hello()

هنا:

1. ‏تُعرَّف الدالة my_decorator التي تستقبل الدالة func كوسيط.


2. ‏تُنشأ داخلها دالة أخرى اسمها wrapper تُنفذ أي كود إضافي قبل وبعد استدعاء func().


3. عندما نضع
@my_decorator فوق الدالة say_hello، فهذا يعني أننا نطبّق التغليف نفسه على الدالة say_hello.


⌯ استخدامات الديكوريتر الشائعة :
ـ = = = = = = = = = = = = = = = = = = = =
• تسجيل النشاط Logging: مثلاً تسجيل وقت تنفيذ الدالة أو القيم المعادة.
• التأكد من الصلاحيات Checking Permissions: مثل أن يُنفذ كود معيّن فقط إن كان المستخدم لديه الصلاحيات المناسبة.
• قياس الأداء Performance Measurement: حساب المدة الزمنية التي تستغرقها الدالة في التنفيذ.
• التخزين المؤقت Caching: لتسريع استدعاء الدوال ذات الحسابات الثقيلة بتخزين نتائجها وإعادة استخدام النتيجة المخبأة عند الاستدعاء مرة أخرى.

⌯ ديكوريتر الدوال والدوال ذات الوسائط ( Arguments ) :
ـ = = = = = = = = = = = = = = = = = = = =
• يمكن استخدام الديكوريتر مع دوال تأخذ وسائط، بحيث يتم تمرير تلك الوسائط للـ wrapper.

مثال:

def decorator_with_args(func):
def wrapper(*args, **kwargs):
print("تم استدعاء الدالة بالوسائط التالية:", args, kwargs)
return func(*args, **kwargs)
return wrapper

@decorator_with_args
def add(a, b):
return a + b

result = add(3, 5)
print("النتيجة:", result)

في هذا المثال:

1. نستخدم *args و **kwargs داخل wrapper حتى نلتقط أي عدد من الوسائط.

2. نطبع الوسائط قبل أن ننفذ الدالة الأصلية.
3. نعيد الناتج النهائي للدالة add.


⌯ ديكوريتر الكلاسات ( Class Decorators ) :
ـ = = = = = = = = = = = = = = = = = = = =
• يمكن أيضاً تطبيق ديكوريتر على الكلاسات بوضع
@decorator_name فوق تعريف الكلاس.
• يتم تمرير الكلاس نفسه إلى الديكوريتر كوسيط، ثم يُعاد كلاس جديد أو نفس الكلاس مع تعديل أو إضافة بعض الخصائص عليه.

مثال بسيط :

def class_decorator(cls):
class NewClass(cls):
def new_method(self):
print("هذه دالة جديدة تمت إضافتها عن طريق الديكوريتر")
return NewClass

@class_decorator
class MyClass:
def original_method(self):
print("هذه الدالة الأصلية من MyClass")

obj = MyClass()
obj.original_method()
obj.new_method()

هنا:

1. يستقبل الديكوريتر class_decorator الكلاس MyClass.

2. ننشئ كلاس جديد اسمه NewClass يرث من MyClass ويحتوي على دالة إضافية.

3. نعيد هذا الكلاس الجديد بدلًا من الأصلي، فيكون بالإمكان استدعاء الدالة الجديدة.

4. كما لايقتصر استخدامه على الكلاسات فقط بل على الدوال أيضاً على سبيل المثال

def check(clc):
def comp(a, b):
if a > 0 and b > 0:
print("pass")
clc(a, b)
else:
print("error")
return comp

@check
def calculator(a, b):
print(a + b)

calculator(0, 5)

في هذا المثال قمنا بتعريف (chack) يقوم بفحص الاعداد اذا كانت اكبر من 0 ومن ثم قمنا باستخدامها في داله (calculator).



tg-me.com/Pythonarabe/1126
Create:
Last Update:

⌯ الديكوريتر ( Decorators ) :
ـ = = = = = = = = = = = = = = =
• الديكوريتر (أو ما يعرف بالمُعلِّق الوظيفي في بايثون) هو أسلوب برمجي يُستعمل للتعديل على سلوك الدوال أو الكلاسات دون الحاجة إلى التعديل على بنية الكود الأصلي.

• يتم ذلك عن طريق تغليف الدالة/الكلاس بدالة خارجية (تسمى الديكوريتر) تضيف أو تحسّن وظائف معيّنة قبل أو بعد أو حتى أثناء تنفيذ الدالة الأساسية.

⌯ كيف نُعرِّف (نستخدم) الديكوريتر ؟
ـ = = = = = = = = = = = = = = = = =
• عادةً يُنشأ الديكوريتر بواسطة دالة عليا ( Higher Order Function ) تستقبل دالة كمدخل، ثم تُرجع دالة جديدة بداخلها، تحتوي على كود إضافي أو معدل (التغليف).

مثال بسيط :

def my_decorator(func):
def wrapper():
print("قبل تنفيذ الدالة ...")
func()
print("بعد تنفيذ الدالة ...")
return wrapper

@my_decorator
def say_hello():
print("مرحباً بالجميع!")

say_hello()

هنا:

1. ‏تُعرَّف الدالة my_decorator التي تستقبل الدالة func كوسيط.


2. ‏تُنشأ داخلها دالة أخرى اسمها wrapper تُنفذ أي كود إضافي قبل وبعد استدعاء func().


3. عندما نضع
@my_decorator فوق الدالة say_hello، فهذا يعني أننا نطبّق التغليف نفسه على الدالة say_hello.


⌯ استخدامات الديكوريتر الشائعة :
ـ = = = = = = = = = = = = = = = = = = = =
• تسجيل النشاط Logging: مثلاً تسجيل وقت تنفيذ الدالة أو القيم المعادة.
• التأكد من الصلاحيات Checking Permissions: مثل أن يُنفذ كود معيّن فقط إن كان المستخدم لديه الصلاحيات المناسبة.
• قياس الأداء Performance Measurement: حساب المدة الزمنية التي تستغرقها الدالة في التنفيذ.
• التخزين المؤقت Caching: لتسريع استدعاء الدوال ذات الحسابات الثقيلة بتخزين نتائجها وإعادة استخدام النتيجة المخبأة عند الاستدعاء مرة أخرى.

⌯ ديكوريتر الدوال والدوال ذات الوسائط ( Arguments ) :
ـ = = = = = = = = = = = = = = = = = = = =
• يمكن استخدام الديكوريتر مع دوال تأخذ وسائط، بحيث يتم تمرير تلك الوسائط للـ wrapper.

مثال:

def decorator_with_args(func):
def wrapper(*args, **kwargs):
print("تم استدعاء الدالة بالوسائط التالية:", args, kwargs)
return func(*args, **kwargs)
return wrapper

@decorator_with_args
def add(a, b):
return a + b

result = add(3, 5)
print("النتيجة:", result)

في هذا المثال:

1. نستخدم *args و **kwargs داخل wrapper حتى نلتقط أي عدد من الوسائط.

2. نطبع الوسائط قبل أن ننفذ الدالة الأصلية.
3. نعيد الناتج النهائي للدالة add.


⌯ ديكوريتر الكلاسات ( Class Decorators ) :
ـ = = = = = = = = = = = = = = = = = = = =
• يمكن أيضاً تطبيق ديكوريتر على الكلاسات بوضع
@decorator_name فوق تعريف الكلاس.
• يتم تمرير الكلاس نفسه إلى الديكوريتر كوسيط، ثم يُعاد كلاس جديد أو نفس الكلاس مع تعديل أو إضافة بعض الخصائص عليه.

مثال بسيط :

def class_decorator(cls):
class NewClass(cls):
def new_method(self):
print("هذه دالة جديدة تمت إضافتها عن طريق الديكوريتر")
return NewClass

@class_decorator
class MyClass:
def original_method(self):
print("هذه الدالة الأصلية من MyClass")

obj = MyClass()
obj.original_method()
obj.new_method()

هنا:

1. يستقبل الديكوريتر class_decorator الكلاس MyClass.

2. ننشئ كلاس جديد اسمه NewClass يرث من MyClass ويحتوي على دالة إضافية.

3. نعيد هذا الكلاس الجديد بدلًا من الأصلي، فيكون بالإمكان استدعاء الدالة الجديدة.

4. كما لايقتصر استخدامه على الكلاسات فقط بل على الدوال أيضاً على سبيل المثال

def check(clc):
def comp(a, b):
if a > 0 and b > 0:
print("pass")
clc(a, b)
else:
print("error")
return comp

@check
def calculator(a, b):
print(a + b)

calculator(0, 5)

في هذا المثال قمنا بتعريف (chack) يقوم بفحص الاعداد اذا كانت اكبر من 0 ومن ثم قمنا باستخدامها في داله (calculator).

BY بايثون العرب | Python Arab 🇵🇸


Warning: Undefined variable $i in /var/www/tg-me/post.php on line 283

Share with your friend now:
tg-me.com/Pythonarabe/1126

View MORE
Open in Telegram


🇵🇸 بايثون العرب Python Arab 🇵🇸 Telegram | DID YOU KNOW?

Date: |

What Is Bitcoin?

Bitcoin is a decentralized digital currency that you can buy, sell and exchange directly, without an intermediary like a bank. Bitcoin’s creator, Satoshi Nakamoto, originally described the need for “an electronic payment system based on cryptographic proof instead of trust.” Each and every Bitcoin transaction that’s ever been made exists on a public ledger accessible to everyone, making transactions hard to reverse and difficult to fake. That’s by design: Core to their decentralized nature, Bitcoins aren’t backed by the government or any issuing institution, and there’s nothing to guarantee their value besides the proof baked in the heart of the system. “The reason why it’s worth money is simply because we, as people, decided it has value—same as gold,” says Anton Mozgovoy, co-founder & CEO of digital financial service company Holyheld.

Why Telegram?

Telegram has no known backdoors and, even though it is come in for criticism for using proprietary encryption methods instead of open-source ones, those have yet to be compromised. While no messaging app can guarantee a 100% impermeable defense against determined attackers, Telegram is vulnerabilities are few and either theoretical or based on spoof files fooling users into actively enabling an attack.

🇵🇸 بايثون العرب Python Arab 🇵🇸 from hk


Telegram بايثون العرب | Python Arab 🇵🇸
FROM USA